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NOTE: PLEASE READ THIS MANUAL BEFORE ATTEMPTING TO INSTALL THE 

APPLE III UNIVERSAL PARALLEL INTERFACE CARD IN THE APPLE 
COMPUTER. INCORRECT INSTALLATION COULD CAUSE PERMANENT DAMAGE 
TO BOTH THE PERIPHERAL DEVICE AND THE APPLE COMPUTER. 
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This manual tells you how to install the Apple III Universal 
Parallel Interface Card (UPIC) and how to use it to perform both 
simple and complex tasks. Before you read this manual, first 
read the Apple III Owner's Guide and Chapters 1 and 2 of the 
Apple III Standard Device Drivers manual. 

This manual has six chapters and five appendices. If your plan 
is simply to install the UPIC, connect one of the commonly used 
printers, and then start using it immediately, Chapters 1 and 2 
may be all you need to read. Chapter 1 explains how to install 
the UPIC in your Apple III. Chapter 2 gives general instructions 
for connecting the cable from the UPIC to a device (for example, 
to a printer or another computer), and for setting up the Device 
Driver needed for data transfers. Chapter 2 also contains all 
the specific information you need if you are going to use one of 
these commonly used printers: 

Centronics 700, 730, 737 and 779 

Anadex DP-8000 

Printronix P300 

IDS 440, 445, 460 

Epson MX- 80 

Texas Instruments 810 

If you wish to attach a different type of parallel printer, read 
Chapter 1, then Chapter 4, then Chapter 2. To connect your 
Apple III to another Apple III, another type of computer, or a 
sophisticated printer that requires a 40-pih connection, read 
Chapter 1, then Chapter 5, then Chapter 2. 
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If you want to run a parallel printer with BASIC or Pascal, read 
Chapter 3 for an outline of the methods to use. If you are an 
advanced programmer and want more detailed control over the 
printer's operation and status, read Appendix B. 

Chapter 6 is a functional and hardware description of the UPIC. 
While reading it, you will want to make reference to the 
schematic diagram in Appendix C. (Appendix C also contains a 
list of UPIC specifications and a brief description of its 
performance.) Appendix D describes the pins and signals 
available in each of the Apple III Peripheral Connector slots. 



Appendix A explains how to run a parallel printer via the UPIC 
when the Apple III is in Apple II Emulation mode. 

Appendix E contains an ASCII conversion table. 

Appendix F explains step-by-step how to prepare the Printer or 
Parallel Driver and install it on your boot diskettes if you 
have Version 4.0 of the System Utilities diskette. 

The glossary has definitions for most of the important or 
unusual terms used in this manual. 

This manual uses two symbols to point out paragraphs of special 
interest. The symbols are: 




The hand points to paragraphs that contain especially 
useful or noteworthy information. 




The eye gazes on paragraphs that explain an unusual 
feature to look out for. 
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The Apple III Universal Parallel Interface Card (UPIC) is a 
simple yet powerful extension to your Apple III, Using nothing 
other than the UPIC, a cable, and what is supplied on the 
diskette that came with the UPIC, you can set up your Apple III 
to do eight-bit parallel data transfers either to a printer, or 
both to and from a terminal or another computer. This chapter 
describes how to unpack, prepare and install the UPIC. 



Unpacking 



The package your Apple III Universal Parallel Interface Card 
(UPIC) came in should include: 

- the UPIC itself 
this manual 

a diskette containing the UPIC Driver Software 

- a Warranty Registration Card 

an Apple III User Input Report Form 

- a packing list 

Fill out the Warranty Registration Card and mail it in right 
away. If any item is missing, contact the Apple dealership 
where you purchased the UPIC. 
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Figure 1-1. The Universal Parallel Interface Card (UPIC) 



Preparing a Backup Diskette 



The diskette that came with this product contains important 
software you will need for as long as you use the UPIC. Lest 
anything happen to your one and only copy of this diskette, we 
strongly urge you to make a duplicate copy. Use the Copy 
Diskette utility program described in the Apple III Owner's 
Guide. Then put the original diskette in a safe place, but not 
too safe: you may need to find it again. Your backup copy of 

the UPIC diskette is now the one you should use. 



Preparing the UPIC 



Set the switch marked Printer L.F. on the UPIC to NORM; that 
is, the same way it is set in Figure 1-1 (unless you plan to use 
the UPIC in Apple II Emulation mode, in which case refer to 
Appendix A). The UPIC is now ready to install. 




Before opening the Apple III, be sure that the power is 
turned off. However, DO NOT unplug the Apple III. The 
ground connection through the power cord helps prevent 
damage to the Apple Ill's internal parts. 
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The /nsfa//af/on Procedure 

First, you must remove the cover of the Apple III. Turn the 
Apple III over and locate the two cover attachment screws 
halfway up each side of the bottom panel. Loosen each screw a 
quarter turn, and then turn the Apple III right-side up with the 
keyboard facing you. Now, lift the top cover and carefully pull 
it toward you and off. 

Figure 1-2 shows the four Apple III peripheral connector slots. 
You can insert the Apple III UPIC in any one of these slots, 
although for Apple II Emulation mode you ordinarily install it 
in slot 1 (see Appendix A). 




Figure 1-2. Peripheral Connector Slots 



Remove the dummy card, if necessary, from the slot you intend to 
use. Then grasp the upper corners of the UPIC so that the gold 
fingers of the edge connector point down, and the printer cable 
connector is toward the back of the Apple III. Insert the UPIC 
in the chosen slot, making sure the metal Radio Frequency 
Interference (RFI) shield fits snugly against the Apple's case 
and the front edge of the UPIC slides into the vertical guide. 
Gently rock the UPIC back and forth until it is firmly seated. 
Figure 1-3 shows how the UPIC looks if installed in slot 1. 
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Figure 1-3. The UPIC Installed in Slot 1 

Replace the top, carefully slipping the four tabs along the back 
of the cover into the corresponding four square holes in the 
case. Turn the Apple upside down again, and then push in and 
retighten the two cover attachment screws. 




The Final Two Steps 



There are two final steps you must perform before you can run a 
device with the UPIC: 

- prepare and connect the cable 

- set up the device driver 

Chapter 2 explains how to perform these steps, and includes 
all the specifics necessary to prepare any one of the 
parallel printers most commonly used with the Apple III. 

If you intend to attach and run some other kind of parallel 
printer, read Chapter 4 first, then follow the general procedure 
given in Chapter 2. If, on the other hand, you intend to attach 
your Apple III to a sophisticated printer or terminal, or to 
another computer — for example, a second Apple III — read Chapter 
5 and then Chapter 2. 
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This chapter describes what you must do to set up your Apple III 
with any of these parallel printers: 

Centronics 779, 700, 730 or 737 
Anadex DP 8000 

- Printronix P300 

- IDS 440, 445 or 460 

- Epson MX- 80 

- Texas Instruments Model 810 

If you have another type of parallel printer, first read 
Chapter 4 to determine what special settings and connections 
you need, then follow the procedures in this chapter. If, on 
the other hand, you intend to connect a sophisticated printer, a 
terminal, or another computer (such as a second Apple III) via 
the UPIC, read Chapter 5 first, then this chapter. 



The Simple Printer Connection: 20 Pins 

You are going to attach your printer to the Apple III using 
the 20 center pins of the 40-pin connector that now protrudes 
from the rear of the Apple Ill's case. The remaining pins 
are concealed and protected by two plastic shields, as shown in 
Figure 2-1. Note carefully the arrangement of the pin numbers. 
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Figure 2-1. The 20-Pin UPIC Male Connector 



ne Printer Cable 

If you already have an Apple parallel printer cable (from an 
Apple II Parallel Printer Card) you can connect it to the Apple 
III without modification. However, you then must set the first 
two parameters in the DCB (see Table 2-2) to 00. 

Your Apple dealer ordinarily has ready-made cables in stock for 
Centronics 737 and 779 printers, as well as the equipment 
necessary to prepare cables for connection to other devices. 

If you have a cable with a 20-pin connector already attached at 
the UPIC end (also available from your Apple dealer), and you 
want to attach the connector on the printer end of the cable, 
use Table 2-1 as a guide. The UPIC pin numbers are those 
stamped on the 20-pin connector. The printer connector pin 
numbers refer to the lines as they are designated in each 
printer's manual. 

If for any reason you are also furnishing your own 20-pin female 
connector for the UPIC end of the cable, be sure it has a mating 
key (Figure 2-2) for the key slot on the UPIC's male connector. 
Unkeyed connectors can be plugged in the wrong way — and that can 
spell disaster. 
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Figure 2-2. A Keyed 20-Pin Female Connector 




If you are making the interconnecting cable yourself, use 
a good grade of stranded ribbon cable of 26-28 gauge wire. 
Stranded wire can withstand much more flexing than solid 
wire, and will give you far less trouble. 



Figure 2-3 shows a sample cable with a Printronix connector. 




Figure 2-3. A Sample Cable 




If the 20-pin connector on your cable does not have a 
mating key, you must be absolutely certain that the 
connectors are properly aligned. Improper alignment can 
result in severe damage to your UPIC. 
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UPIC 

Pin# 




Printer Connector Pin 


Number 








Centronics 


Anadex 


Printronix 


IDS 


Epson 


TI 




(779/700) 


(730/737) 


DP-8000 


P300 


(440/45/60) 


I IX— 80 


810 


1 


14 


27 


14 


14 


7 


9,19 


19 


2 


10 


19 


10 


10 


22 


10 


10 


3 
















4 
















5 
















6 












32 


32 


7 
















8 


1 


1 


1 


1 


3 


1 


1 


9 


12 




12 


12 


12 


12 


12 


10 


2 


3 


2 


2 


14 


2 


2 


11 


3 


5 


3 


3 


13 


3 


3 


12 


4 


7 


4 


4 


12 


4 


4 


13 


5 


9 


5 


5 


11 


5 


5 


14 


6 


11 


6 


6 


10 


6 


6 


15 


7 


13 


7 


7 


9 


7 


7 


16 


8 


15 


8 


8 


15 


8 


8 


17 


9 


17 


9 








9 


18 


13 


25 


13 


13 


4 


13 


13 


19 


18 


28 


18 


18 




35 


18 


20 


16 


31 


16 


9,16 


7 


30,33 


16,27 



Table 2-1. Pin Assignments for Commonly Used Printers 



Preparing and Installing a Device Driver^ 

The Apple III does not "talk" directly to whatever is connected 
to it. Instead, the Apple uses a set of computer instructions 
called a device driver to pass information to and from whatever 
is connected to it. Two of these device drivers are furnished 
on the diskette that comes with the UPIC: 

-One is for sending information to parallel printers 
(a driver called .PRINTER). 

-One is for exchanging information with a remote terminal 
or another computer, such as another Apple III 
(a driver called .PARALLEL). 
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This section gives the general procedure for tailoring a driver 
to the device you are using, and then adding it to the 
collection of drivers on each of your "boot" diskettes. This 
section also provides all the specific settings you need to 
tailor the Printer Driver (.PRINTER) to any one of the printers 
listed at the start of this chapter. 

Why Device Drivers? 

Each time you start up ("boot") your Apple III, it loads into 
memory not only the operating system (SOS), but also all the 
device drivers from the file SOS. DRIVER on the boot diskette you 
are using. Each driver is designed to handle or "drive" one of 
the devices connected to the Apple III. The Apple III can 
communicate only with those devices represented by device 
drivers, and to no others. Thus, every boot diskette you want 
to use with a parallel device must contain either the Printer 
Driver (.PRINTER) or the Parallel Driver (.PARALLEL). 

The General Technique 

The actual sequence of keystrokes required to perform the 
procedure explained in this section can be found in the 
Apple III Standard Device Drivers manual. 




If you have Version 4.0 of the Utilities Diskette, 
refer to Appendix F for the exact keystrokes to use. 



First make a backup copy of the UPIC diskette (Chapter 1) and 
store it in a safe place. To prepare the boot diskettes: 



1. Bring the appropriate driver into the Apple III. Insert 
the System Utilities diskette in the built-in drive and 
boot the Apple III. From the menu, select the System 
Configuration Program (SCP) and the Add a Driver function. 

2. Modify the driver's Configuration Block for your specific 
device. Table 2-2 (below) gives the correct values for a 
number of commonly used printers. Chapters 4 and 5 explain 
how to derive these values for other printers or parallel 
devices . 



If you connect a printer to the UPIC with an Apple II 
^ ' Parallel Printer Card cable, you must set each of the first 
two parameters of the Configuration Block to 00. 
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3. If the UPIC is in a slot other than #1, change its Peripheral 
Slot Assignment. 

4. Save the configured driver on the UPIC diskette. 

5. Prepare each boot diskette for the new driver by removing or 
renaming, if necessary, any existing driver named .PRINTER 
that is on that diskette. 

6. Bring the configured driver into the Apple III from the UPIC 
diskette. 

7. Generate a new system for the boot diskette, with the new 
driver in it. If there are errors, repeat the first four 
steps given above, following closely the procedures given 
in the Apple III Standard Device Drivers manual. 

8. If there are no errors in the new system configuration, save 
it on the boot diskette you are changing. Repeat steps 5 
through 8 until you have reconfigured all the boot diskettes 
you plan to use with the .PRINTER or .PARALLEL driver. 



In Apple II Emulation mode, the system does not use 
device drivers. Therefore, you do not need to add a 
driver to any diskettes you use in that mode. 
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This chapter describes the commands to put in BASIC and Pascal 
programs to run a parallel printer. It assumes that you know 
how to write programs in at least one of the two languages; 
however, even if you don't, you can type in the BASIC examples 
to see how they work. 

For these examples to work, you must first follow all the 
procedures in Chapter 2 — including preparation of the .PRINTER 
driver to work with your specific printer. Also, if you have 
given .PRINTER a different name, you should modify the sample 
programs accordingly. 



Running the Printer with BASIC 



This section illustrates general techniques for using your 
printer with BASIC. It gives examples of commands, but does not 
explain all their variations. For details, read the Apple III 
Business BASIC manual. 

Before a BASIC program can send anything to the parallel 
printer, the program must assign a file reference number to it 
with an OPEN// statement. 

For example: 

OPEN# 5, ".PRINTER" 

This assigns file reference number 5 to the device named 
.PRINTER. After this particular OPEN# statement, all 
information sent to file number 5 will be directed to the 
printer, unless you CLOSE# 5 or OPEN# 5 as another device. Note 
that the file reference number has no relation to the number of 
the slot where you installed the UPIC. 
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If you use the alternate form of the OPEN# statement 
OPEN# 5 AS OUTPUT, ".PRINTER" 

accidental INPUT statements from file number 5 will be flagged 
as BASIC errors rather than as printer errors. 

There are two ways to send information to a printer in BASIC: 
use either the OUTPUT# statement or the PRINT# statement. 

The OUTPUT# statement sends to the printer all information that 
would normally appear on the screen as a result of the PRINT, 

LIST or CATALOG statements. For example, the program 

10 OPEN# 5 AS OUTPUT, ".PRINTER" 

20 OUTPUT# 5 
30 LIST 

prints its own three lines on the printer. A program that uses 
the OUTPUT# statement to send data to a device cannot send 
characters to the screen with the PRINT, LIST or CATALOG 
statements until another statement in the program, such as 
OUTPUT# 0, redirects the information to the console. 

The second way to send information to the printer is to use 
the PRINT# statement. Although you must specify the file number 
each time you use PRINT#, you can send information to the 
screen more easily than with OUTPUT#. For example the program 

10 OPEN# 5, ".PRINTER" 

20 PRINT# 5; "This is all the news that's fit to PRINT." 

30 PRINT "This is a screen test." 

sends the first quoted sentence to the printer, and the second 
one to the console. Try it! 

Use a CLOSE# statement to remove the links produced by the OPEN# 
statement. For example, use CLOSE# 5 to "close" the .PRINTER in 
its guise as file number 5. 

If you are a reasonably experienced programmer, and you want to 
have speedy and detailed control over the workings of the printer, 
you can use the control and status requests provided on the UPIC 
diskette in the form of invocable modules. Appendix B explains 
the requests, and shows you how to invoke them. 
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Running the Printer with Pascal 



Like the section on printing with BASIC, this section gives a 
few general examples of how to run the printer from a Pascal 
program. For details, read the Apple III Pascal Programmer's 
Manual. 

Before your program can communicate with the file that it will 
call PRINTER:, it must give that file an identifier and a type. 
So first define it as a variable with identifier P (for 
example), and as type "text" or "file of characters," using one 
of the following declarations: 

VAR P : TEXT ; or 
VAR P:FILE OF CHAR; 

Next, equate the identifier P with the driver name .PRINTER 
using the REWRITE command: 

REWRITE (P, 'PRINTER: ' ); 

This command also prepares the printer to receive information 
from the program. 




Pascal automatically drops the dot before Apple III 
driver names, and adds a colon after it (for example, 
changing .PRINTER to PRINTER:). This makes the names 
consistent with the pathnames in UCSD Pascal, from 
which Apple III Pascal is derived. 



Now you can send information to the printer using WRITE 
statements; or you can use the WRITELN statement, which 
automatically sends a carriage return at the end of the 
information to print. For example 

WRITELN(P, 'If Peter Piper printed Pascal programs painlessly'); 

WPvITE(P , 'Where' 's a painlessly printed Pascal program'); 

WRITELN(P,' Peter Piper printed?'); 



causes your tongue to tangle on two lines of a printed page, while 

WRITE('She sells shilling sea shells'); 

WRITE ('on the sharp-sloped seashore'); 

claims but one of the console's 24 lines. (Note: if you don't 
specify P, The information automatically goes to the console.) 
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When you have finished sending information to the printer, close 
its file with the statement 



CLOSE P; 
That's that. 



Here is a small but complete Pascal program to try: 



PROGRAM PRINT_IT; 

VAR P : TEXT ; 

Y,Z: INTEGER; 

BEGIN 

REWRITE (P, 'PRINTER: ' ); 

FOR Y := 1 TO 5 DO BEGIN 

FOR Z := 1 TO Y DO WRITE(P,' 
WRITELN(P , '*' ) 

END; 

CLOSE (P) 

END. 



{ Y and Z are indexes for loops} 

{ Prepare the printer. } 

{ On 5 separate lines } 

');{ print Y-l blanks } 

{ followed by *. } 

{ Close the printer file.} 



This program produces the following on 



the printer: 



* 

* 



* 

* 

* 



Status and control requests (Appendix B) are available on the 
UPIC diskette in the form of invocable modules for use with the 
standard Apple III Pascal procedure 'UNITSTATUS . ' 

The .PRINTER driver can also run a printer in Apple II 
Emulation mode. Read Appendix A for details. 
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Other Printers 



This chapter gives you the information you need if you want to 
configure the Printer Driver to a parallel printer other than 
the kinds listed in the Preface. The first section discusses 
the UPIC device drivers in general. The next section gives the 
pin assignments for construction of a cable; the final two 
sections explain the Printer Driver and its Configuration Block 
values . 

The exact purpose of each wire coming out of the Apple III 
UPIC is specific to each application. The design of the UPIC 
enables the driver to control the relationships between the 
signals coming into the UPIC from a device and the signals going 
out of the UPIC to that device. 



The Driver Modules 



Two code modules, known as device drivers, come with the 
Apple III UPIC. Each is written for a special purpose, and each 
sends out and expects to receive signals and data according to a 
certain format. 

The first module, the Printer Driver (.PRINTER), sends data to 
parallel printers, which receive one character at a time. This 
driver uses a 20-pin connection. The remainder of this chapter 
tells you how to connect the UPIC to a printer — even ones not 
listed in the Preface — and what values to set for .PRINTER to 
run it. Once you have determined these connections and values, 
follow the procedures given in Chapter 2. 

The second module, the Parallel Driver (.PARALLEL), uses a 
40-pin connection. This driver is discussed in Chapter 5. 
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Pet ermining Pin /iss/gnmenfs 

The Printer Driver requires only the center 20 pins on the UPIC 
connector. The 20 connector pin assignments, as used by the 
Printer Driver, are as follows. 



Pin Number 


Function 


1 


Signal Ground 


2 


ACKNOWLEDGE INPUT 


3 


Data Input Bit 0 


4 


Data Input Bit 1 


5 


Data Input Bit 2 


6 


Printer In Check Input 


7 


Printer Fvibbon Out Input 


8 


STROBE OUTPUT 


9 


Printer Out of Paper Input 


10 


Data Output Bit 0 (LSB) 


11 


Data Output Bit 1 


12 


Data Output Bit 2 


13 


Data Output Bit 3 


14 


Data Output Bit 4 


15 


Data Output Bit 5 


16 


Data Output Bit 6 


17 


Data Output Bit 7 (MSB) 


18 


Printer Online Input 


19 


Printer Power On Input 


20 


Signal Ground 



Table 4-1. The 20-Pin Connection 

Table 2-2 (in Chapter 2) shows pin assignments for several 
commonly used printers, namely: 

- Centronics 779 or 700 

- Centronics 730 and 737 

- Anadex DP 8000 

- Printronix P300 

- IDS 440 or 445 or 460 

- Epson MX- 80 

- Texas Instruments Model 810 

If your printer is one of these, Chapter 2 lists all the pin 
connections and driver values for you. If you have some other 
type of printer, look in the printer's instruction manual to 
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determine which of the pins shown in Table 4-1 corresponds to 
each of the pins on your printer. Use this information to 
fashion a connecting cable from the UPIC to that printer. 

If you are not sure what all the signal lines are, or if your 
printer's instruction manual calls them by other names, read on. 
The next section describes the function of each of the lines. 

You should be able to deduce the proper line connections by 
comparing these descriptions with those in your printer's 
instruction manual. 



The Printer Driver’s Handshake 

The Printer Driver (.PRINTER) is designed to pass information 
between an Apple III and most types of parallel printers. This 
driver is recorded on the diskette that comes with the Apple III 
UPIC. The section of Chapter 2 called The General Technique 
explains how to add .PRINTER to your system configuration. 

The following sections describe the exchange of signals (called 
a "handshake") that takes place between the Printer Driver and 
a printer — in other words, the way the Printer Driver uses the 
lines you connect via the cable. 

Why It’s Called a Handshake 

Each character that the Apple III UPIC sends to a printer is 
sandwiched in an exchange of signals on the STROBE OUTPUT and 
ACKNOWLEDGE INPUT lines. This exchange is very much like one 
person handing a dollar to another via a handshake: 

Person A (extending a hand with the bill hidden in it): 

"Hi, how are you!" 

Person B (shaking hands, receiving bill, and reacting 

automatically): "Just fine, thanks. Got any more?" 

When the UPIC is ready to send a character to the printer, it 
places that character on the eight data lines, waits 5 
microseconds for the data signals to be set up, and then sends 
the STROBE OUTPUT signal. When the printer detects the STROBE 
OUTPUT signal, it receives the character for printing. The 
printer then sends the ACKNOWLEDGE INPUT signal to indicate that 
it has accepted the character and is ready for a new one. This 
is the Printer Driver's Handshake (Figure 4-1). 
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DATA 

pin 

pin 

pin 



< 






pin 

pin 

pin 

pin 

pin 




16 wvv/wwwv\f- 



15 vwwwww^- 
? 



40 ^us minimum 

0 

0 

0 
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14 vwvwwwwi 
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13 vwvwwwwvj 

? 

12 VWWWVWJ 

? 

1 1 wvwwwvwj— — 
? 
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1 

1 

0 
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■^AA/WWVWWWW^- 
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nAAAAA/WVWW 

-wvwwwvw- 
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-wwwvwvw 

-vVWWWVWW 

n/WWWWW^ 

-vwwwvwvw 



STROBE 
OUTPUT 
(pin 8) 



high 

low 



—1 


•* — 3 jus typical strobe pulse 






_p 


U_i 


/ 7 • • 


.1. 


. . . 




r 






4/ yUS minimum 






INPUT ^ lgh 
(pin 2) low 



-H k-i jus minimum 




— *j|-*-50 nanoseconds minimum 



Figure 4-1. The Printer Driver's Handshake 

There is another kind of exchange between the UPIC and the printer. 
Stretching the handshake analogy a bit further: 

Person A: "Here's a report form. Tell me what condition you're 
in to use what I've given you." 

Person B: "I've filled out the report. Knowing me as you do, decide 
for yourself." 

This sort of followup conversation is like a control or status 
request and its reply (Appendix B). 

The order of events in the Printer Driver Handshake, or in a 
control or status request, never varies. However, certain other 
things do vary from one printer to another. These variable 
elements, or "parameters," are stored in the Device 
Configuration Block (DCB): 

- what bits of information to check when evaluating 
the status of the printer (ERRMASK; DCB position 0) 

- whether each bit of an OK status from the printer 
should be ON or OFF (ERRSTAT; DCB position 1) 

- whether or not to suppress sending to the printer 
any <LF> that immediately follows a <CR> (AUTOLF ; 

DCB position 2) 
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- how long to sustain the STROBE OUTPUT signal; what 
polarity to interpret as meaning that the STROBE 
OUTPUT and ACKNOWLEDGE INPUT signals are present 
(CTRLWRD; DCB position 3) 

- how long to wait for an ACKNOWLEDGE INPUT signal reply 
from the printer (TIMEOUT; DCB position 4) 

You may find some of these parameters a bit strange. Be 
patient: the next section will explain how they work. 

If you examine Table 4-2, you will notice that it is the same as 
Table 2-2, with the addition of the names of each of these five 
parameters. Once you have determined their respective values 
for a given printer, you are ready to put them into the DCB 
and install the Printer Driver following the procedures given in 
Chapter 2. 



Printer 


Device Configuration Block (DCB) 


Values 




ERRMASK 

00 


ERRSTAT 

01 


AUTOLF 

02 


CTRLWRD 

03 


TIMEOUT 

04 


Centronics 779/700 


E0 


C0 


40 


00 


0A 


Centronics 730/737 


C0 


C0 


00 


00 


5A 


Anadex DP-8000 


E0 


C0 


00 


00 


5A 


Printronix P300 


E0 


C0 


00 


00 


0A 


IDS 440/445/460 


60 


40 


00 


00 


5A 


Epson MX- 80 


E8 


C8 


00 


00 


0A 


TI 810 

Any printer connected 


E8 


C0 


00 


00 


0A 


with Apple II cable 


00 


00 


(final 


3 same as above) 



Table 4-2. DCB Values for Commonly Used Printers 



The Conf/guraf/on Block 

A group of parameters called a Device Configuration Block (DCB) 
contains the information that tailors each driver to the device 
connected to it. In the case of .PRINTER, these DCB parameters 
are the five listed in Table 4-2 and discussed below: ERRMASK, 

ERRSTAT, AUTOLF, CTRLWRD, and TIMEOUT. 

ERRMASK and ERRSTAT (Error Status) 

.PRINTER monitors printer status through the eight lines of the 
input port. These eight lines correspond to pins 3, 4, 5, 6, 7, 





20 



The Universal Parallel Interface Card 



9, 18 and 19 of the UPIC connector. Each bit of the byte 
ERRMASK corresponds to one of these input port lines (see 
Table 4-3). The Printer Driver monitors each status line whose 
corresponding bit is set to 1 in ERRMASK. 

The eight bits of ERRSTAT correspond to exactly the same input 
port lines. Each bit should be set to the value that the 
printer sends over the corresponding line under error-free 
conditions. Unused bits must be set to 0. 




No matter what printer you use, if you connect it via an 
Apple II Parallel Printer cable, you must set both ERRMASK 
and ERRSTAT to 00. 



Table 4-3 shows the pin number and interpretation of the five 
bits of ERRMASK and ERRSTAT that .PRINTER uses. 



Bit: 


7 


6 


5 


4 


3 


2 


1 


0 


Printer: 


Power 

On 


On 

Line 


Out of 
Paper 


Ribbon 

Out 


In 

Check 








Pin: 


19 


18 


9 


7 


6 


5 


4 


3 



ERRMASK — If bit = 1, corresponding status line is checked 
ERRSTAT — Bits should equal values normally expected 

Table 4-3. ERRMASK and ERRSTAT Bits 



The Printer Driver tests for error conditions as follows. It 
ANDs the eight bits of the input port with ERRMASK. This turns 
off the the unused input bits if they happen to be on. It then 
EXCLUSIVE-ORs that result with ERRSTAT. If any bits of the 
result are still set to 1 after all that, those bits indicate 
printer errors. 

You can use SOS status requests to determine exactly which 
printer error has occurred, and have your program take the 
appropriate action. Appendix B explains these control and 
status requests. 

AUTOLF (Automatic Linefeed) 

If the printer you are using generates its own Linefeed (<LF>) 
character automatically each time it encounters a Carriage 
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Return «CR» , set AUTOLF to 40. .PRINTER will then 
automatically suppress sending to the printer any <LF> that 
immediately follows a <CR>. 

If, on the other hand, the printer does not have this "Auto 
Linefeed" feature, or you have turned it off, set AUTOLF to 00: 
•PRINTER will simply send all <LF> characters, no matter where 
they occur. 

CTRLWRD (Control Word) 

CTRLWRD determines the duration of the STROBE OUTPUT pulse (any 
odd whole-number value from 1 through 15 microseconds), and 
the polarity of the STROBE OUTPUT and ACKNOWLEDGE INPUT pulses: 
either negative and clocked on the rising edge, or positive and 
clocked on the falling edge. 

The usual setting of CTRLWRD is 00; in fact, CTRLWRD is reset 
to zero whenever you reboot the system. As a result, CTRLWRD is 
rigged up so that when set to zero it sets pulse polarities 
at negative and strobe duration at 3 microseconds. The reason? 
Those printers most frequently used with the Apple III run just 
fine when CTRLWRD is set to zero. Check Table 4-4 and see. 

The strobe bits are tricky. Look closely at the interpretation 
of bits 0, 1 and 2 in Table 4-4. Remember that all zeros means 
3 (that is, 3 microseconds). Believe it or not, you can set 
those bits to mean any odd number from 1 through 15. For 
example, to get 13, set all three bits to 1 (3 - 2 + 4 + 8). 



7 


6 


5 


4 


3 


2 


1 


0 






Strobe 

Positv 




Ack In 
Positv 


Strobe 
+8 yus 


Strobe 
+4 /is 


Strobe 
-2 /is 



Table 4-4. Meaning of Ones in CTRLWRD 

TIMEOUT (Waiting Time Limit) 

TIMEOUT determines the maximum time .PRINTER is to wait for the 
ACKNOWLEDGE INPUT signal from the printer. If the Printer 
Driver is trying to send a character to the printer, and it 
doesn't receive the acknowledge signal within (TIMEOUT x 11) 
microseconds, it sets interrupts on the UPIC, and then returns 
to whatever it was doing previously. When UPIC interrupts are 
set, the Apple III resumes sending characters (and turns the 
interrupts off) as soon as it receives the ACKNOWLEDGE signal. 
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A parallel printer generally loads characters rapidly into a 
temporary storage area called a line buffer until the entire 
line is in this buffer; then it prints out the line, which takes 
between 0.2 and 5 seconds. The printer cannot send the 
ACKNOWLEDGE INPUT signal until it has printed the entire line. 

The Apple III can spend this 0.2 to 5 second interval doing much 
more productive things than waiting for the ACKNOWLEDGE signal; 
for example, it could be processing data in an applications 
program. Therefore, TIMEOUT should represent more time than the 
printer needs to accept a character, but less time than it needs 
to print a line. 

For example, for printers such as the Centronics 779 and 
Printronix P300, the interval between the STROBE pulse and the 
ACKNOWLEDGE pulse is typically less than 10 microseconds. A 
waiting period of 110 microseconds (TIMEOUT = $0A) is adequate 
to ensure that not too much time is spent waiting for the 
ACKNOWLEDGE signal while a line is being printed. 




It is much better to have a TIMEOUT that is too big than 
one that is too small. If the WAIT is less then the 
printer's response time, an interrupt will be generated 
for every character transferred. This would seriously 
degrade the performance of the system. 



A Sample Printer Driver Application 

Appendix B explains how to use the control and status requests 
to get the best possible performance from your printer. The 
following is merely an example. 

Normally, if you send data to the printer while it is turned 
off, neither the printer nor the program will do anything. 

You can avoid this condition using Printer Driver status request 
number 3. The printer will send back not only its status, but 
also the number of characters currently in the output buffer and 
the buffer's size. As a result, your program can always check 
for possible errors before sending data, and arrange to send 
only as many characters as the output buffer currently has room 
for. 
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This chapter explains the pin connections from the UPIC to a 
sophisticated printer, a terminal, or another computer. It also 
describes how to set up the Parallel Driver (.PARALLEL). Once 
you have done this, follow the procedures in Chapter 2. 



The Para//e/ I/O Connecf/on: 40 P/ns 

The Parallel Driver uses a 40-pin connector. Before using it, 
you need to remove the two plastic shields from the UPIC 
connector by grasping each one by the tab and pulling firmly. 
They should pop right out. Figure 5-1 shows how the connector 
looks before and after removing them. Table 5-1 shows the 
pin numbering schemes and signal assignments. 




Before (20 pins) After (40 pins) 

Figure 5-1. The UPIC Connector 
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20-pin 

Connection 



40-pin 

Connection 



Signal Definition 



1 


2 


3 


4 


5 


6 


7 


8 


9 


10 


11 


12 


13 


14 


15 


16 


17 


18 


19 


20 



1 


2 


3 


4 


5 


6 


7 


8 


X 


X 


11 


12 


13 


14 


15 


16 


17 


18 


19 


20 


21 


22 


23 


24 


25 


26 


27 


28 


29 


30 


X 


X 


'33 


34 


35 


36 


37 


38 


39 


40 



Port B output DO0 
Port B output D01 
Port B output D02 
Port B output D03 
Port B output D04 
Port B output D05 
Port B output D06 
Port B output D07 
(pin removed) 

(pin removed) 
Signal Ground 

ACKNOWLEDGE INPUT 
Port B input DI0 
Port B input Dll 
Port B input DI2 
Port B input DI3 
Port B input DI4 
STROBE OUTPUT 
Port B input DI5 
Port A output DO0 
Port A output D01 
Port A output D02 
Port A output D03 
Port A output D04 
Port A output D05 
Port A output D06 
Port A output D07 
Port B input DI6 
Port B input DI7 
Signal Ground 
(pin removed) 

(pin removed) 

DATA READY OUTPUT 
Signal Ground 
Signal Ground 
Signal Ground 
Signal Ground 

DATA READY ACK IN 
Signal Ground 
Signal Ground 



Table 5-1. UPIC Connector Pin Assignments 
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Notice that a driver program has a considerable number of 
signals available for use. It can simultaneously send up to 
sixteen bits of information to a parallel device through output 
ports A and B, or receive up to eight bits of data at a time 
through input port B. Furthermore, the driver can regulate the 
timing of transfers to and from the card with the four lines 
ACKNOWLEDGE INPUT, STROBE OUTPUT, DATA READY OUTPUT, and DATA 
READY ACKNOWLEDGE INPUT (pins 12, 18, 33 and 38, respectively, 
of the 40-pin connection). 



The Parallel Driver’s Dual Handshake 



The Parallel Driver has two pairs of handshaking lines: one 

pair for data transfers to the device, and another pair for 
transfers from the device. The section of Chapter 2 titled Why 
It's Called a Handshake explains this transfer method. 

A convenient and practical way to illustrate the Parallel Driver's 
dual handshake is in terms of the Apple III to Apple III connection. 
Table 5-2 shows the pin assignments for connection of two Apple 
Ills that both have UPICs installed in them. Notice that the 
connections are symmetrical: Apple A pin 1 is connected to 

Apple B pin 13; Apple B pin 1 is connected to Apple A pin 13, 
and so on. 

There are two separate handshakes for parallel I/O transfers: 
one for output (using STROBE OUTPUT and ACKNOWLEDGE INPUT), and 
one for input (using STROBE INPUT and ACKNOWLEDGE OUTPUT). All 
handshake and data line names indicate in what direction the 
data flows in the transfer (A to B; B to A) . The handshake 
line names also indicate the direction of the signal with 
respect to Apple A (OUTPUT or INPUT). 

In the descriptions that follow, all line and pin numbers refer 
to Apple A, and numbers in parentheses refer to points on the 
corresponding timing diagrams. Time intervals in the two 
diagrams are not to scale. 
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Apple A 
Pin Number 


Apple B 
Pin Number 


Function 


1 


13 


Data A to B Bit 0 


2 


14 


Data A to B Bit 1 


3 


15 


Data A to B Bit 2 


4 


16 


Data A to B Bit 3 


5 


17 


Data A to B Bit 4 


6 


19 


Data A to B Bit 5 


7 


28 


Data A to B Bit 6 


8 


29 


Data A to B Bit 7 


9 




Unused 


10 




Unused 


11 


11 


Signal Ground 


12 


33 


A to B ACKNOWLEDGE INPUT 


13 


1 


Data B to A Bit 0 


14 


2 


Data B to A Bit 1 


15 


3 


Data B to A Bit 2 


16 


4 


Data B to A Bit 3 


17 


5 


Data B to A Bit 4 


18 




Unused 


19 


6 


Data B to A Bit 5 


20 


38 


A to B STROBE OUTPUT 


21 




Unused 


22 




Unused 


23 




Unused 


24 




Unused 


25 




Unused 


26 




Unused 


27 




Unused 


28 


7 


Data B to A Bit 6 


29 


8 


Data B to A Bit 7 


30 


30 


Signal Ground 


31 




Unused 


32 




Unused 


33 


12 


B to A ACKNOWLEDGE OUTPUT 


34 


34 


Signal Ground 


35 


35 


Signal Ground 


36 


36 


Signal Ground 


3 7 


37 


Signal Ground 


38 


20 


B to A STROBE INPUT 


39 


39 


Signal Ground 


40 


40 


Signal Ground 



Table 5-2. Apple III to Apple III Pin Connections 
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The Output Handshake 

The output handshake proceeds like this (Figure 5-2): 

1. When Apple B is ready to accept data, it sets A to B 
ACKNOWLEDGE INPUT high (1). 

2. This sets into motion the output sequence. After 
waiting a minimum of 44 microseconds, the Parallel 
Driver places data on the Data A to B lines (2), and 13 
microseconds later signals that the data is there with 
an 8 microsecond pulse on A to B STROBE OUTPUT (3-4). 

3. When Apple B detects valid data, it reads the data. 
Within 12 microseconds after it receives A to B STROBE 
OUTPUT, Apple A sets A to B ACKNOWLEDGE INPUT low 
(5). This pulse should stay low for at least 50 
nanoseconds (6) if the receiver will not immediately 
be ready for the next byte. 



© 



©© 



A to B 
ACK IN 
(pin 12) 



DATA 
A to B 





pin 

pin 

pin 

pin 

pin 

pin 

pin 

pin 




A to B 
STROBE 
OUT 

(pin 20) 




©W© 



Figure 5-2. Parallel Output Handshake 
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The Input Handshake 

The procedure for data input is similar (Figure 5-3): 

1. As soon as Apple A is ready to read data, the Parallel 
Driver sets B to A ACKNOWLEDGE OUTPUT high (7). 

2. When Apple B detects that B to A ACKNOWLEDGE OUTPUT is 
high, it waits at least 1 microsecond before sending 
data to the input port (8). Apple B indicates to 
Apple A that there is data on the bus by setting the 

B to A STROBE INPUT line high for at least 50 
nanoseconds (9). The data must remain valid for at 
least 1 millisecond or until Apple A sets B to A 
ACKNOWLEDGE OUTPUT high. 

3. When it detects B to A STROBE INPUT, Apple A 
immediately sets B to A ACKNOWLEDGE OUTPUT low (10). 

It spends at least 43 microseconds processing the 
character before it sets B to A ACKNOWLEDGE OUTPUT high 
to signal that it is ready for the next transfer (11). 



B to A , . , ® 

A nv OTTT high 


r 


i® ,, . . © 

43 /is minimum 


r 




ALK UU1 -i 

(pin 33) l0W 

B t0 A high — 

QTPfYRT? o 


© 

50 ns minimum 




1 


O 1 i\UD Hi - 

IN (pin 38) loW “ * 

— 

DATA pin 29 amaa/wwv 

B tO A . OO AAA1A4AA1 iAA 


"I H — 1 jas minimum 
® 

\- — 1 jjs minimum 
0 


~r 

! 

m'L 






1 


#v r 




piLl Z.O 


0 


nT 

i 

i 

J>Aj_ 




pXn 19 AMtyWVSAAM/W^r 
1 

w— 4 n i n 17 ajiaaaaaaaaa/v^aaaL 


0 


”y 




^ pill 1 / 'WVVWVYWWVtj- 

H ^ 


T 

1 

j 


yW- 




h la pin 16 /Wwvwwwvw- 

o g 

Vj _T3 1 C AAAAlAAAMAA/UUttl 


i 

1 


! 

imL 




h-« pin 13 'WYVVVVYWYVW**- 

1 


0 


"i 

ml- 




p ± n J /vvvwvwvvwa{- 
! 

„ -I „ IQ AAAliA.AAAAui 


1 


LJ 




pxil JL ^yyvvvy»viv*r 

— 1 ms minimum or until — ► 





ACK OUT again high 



Figure 5-3. Parallel Input Handshake 
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The Configuration Block 



The Device Configuration Block (DCB) for the Parallel Driver 
has only three parameters: 

- LFREM removes <LF> whenever it immediately follows <CR> 
(DCB position 0) 

- IMREAD determines whether or not the driver should 
wait for enough characters or simply read what is 
currently in the input buffer and quit (DCB position 1) 

- CTRLWRD sets the polarity of the handshaking signals 
(DCB position 2) 

When two Apple Ills with UPICs are connected together, set 
all three parameters to 00 (their default setting) using the 
System Configuration Program. The sections that follow 
describe how to determine the settings of the Parallel Driver 
parameters for other applications. 

LFREM (Remove < LF )) 

Pascal and BASIC expect each input statement to end with a <CR> 
but no <LF>. Both languages mistakenly interpret <LF> after 
<CR> as the first character of the next command. Set LFREM to 
40 to have .PARALLEL automatically remove any <LF> that 
immediately follows a <CR>. 

If the Apple III is to transmit normal 8-bit data, set LFREM 
to 00. 

IMREAD (Immediate Read) 

If you set IMREAD to 40, the Parallel Driver reads whatever 
characters are currently in the input buffer, (however few) and 
then returns control immediately to the program that made the 
read request. If you set IMREAD to 00, this does not occur. 

No matter which way IMREAD is set, two other conditions cause 
data reading to stop: 

- the requested number of characters have been transferred 

a byte called IS_NEWLINE contains FF and the driver 
receives the same character as the one stored in a field 
called NEWLINE 
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Control request #2 (described in Appendix B) determines the 
contents of both IS_NEWLINE and NEWLINE. 

CTRLWRD (Control Word) 

CTRLWRD sets the polarities of the handshaking signals the UPIC 
uses. If a bit is set to 1, the corresponding two signals are 
negative; that is, clocked on the falling edge (0V is "high"). 
If a bit is set to 0, the two signals are positive — clocked on 
the rising edge (5V is "high"). 



7 


6 


5 


4 


3 


2 


1 


0 








l=pos 


l=pos 









ACKNOWLEDGE INPUT and DATA 
READY ACKNOWLEDGE INPUT polarity 

DATA READY OUTPUT polarity 
Table 5-3. CTRLWRD Bit Assignments 



Parallel Driver Applications 



This section explains several advanced applications of the 
UPIC used with the Parallel Driver. These applications make use 
of status and control requests (Appendix B); thus, unless you 
are an experienced programmer, you may have difficulty using 
them. 

Apple III to Apple III 

The .PARALLEL driver doesn't define any conventions for the 
start or termination of a file transfer. It merely writes 
characters when the receiver indicates that it is ready, and 
reads characters when Apple A is ready and data is valid. Thus 
your sending and receiving programs must signal the start and 
end of files. 

The simplest way to transfer text files is to use the GET 
statement with a string variable to get one character at a time. 
When the receiving program reads a string of length zero, a 
carriage return has been read and it should write a carriage 
return to the destination file. The sending program should send 
a <CTRL-C> as an end-of-file character. <CTRL-C> is read by 
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the GET statement as a valid character, and it cannot normally 
be in a text file. For this type of transfer, set both IMREAD 
and LFREM to 40. 

Data files are more difficult to transfer since the data stream 
can contain any of the control characters. In this case you 
should probably send the length of the block of data in the 
first bytes of the transfer. For this type of transfer, set 
both LFREM and IMREAD to 00. 

Terminal Emulator 

If you use an Apple III as a terminal for another Apple III, you 
can turn IMREAD and LFREM on, and use the following Business 
BASIC program to read characters entered at the other Apple's 
keyboard and display them on the screen: 



10 


OPEN# 1 .PARALLEL" 


: REM 


TURN 


ON CARD 


20 


ON KBD GOTO 100 


: REM 


GOTO 


100 IF KEY PRESSED 


30 


GET#1 A$: PRINT A$;:GOTO 30 


:REM 


READ 


CHARACTERS 


100 


PRINT# 1; CHR$ (KBD); 


:REM 


SEND 


TYPED CHARS 


110 


GOTO 20 









Output Port 

You can convert the Apple III UPIC into a 16 bit output port 
(using Output Ports A and B) without too much difficulty. The 
advantage of a port is that it holds a character stable on the 

output lines until the next character is sent to it. Output 

Port A is at address C080 + s0; Output Port B is at address 

C081 + s0 (in both cases, s is the slot number). Refer to the 

section of Chapter 6 called Summary of Hardware Addresses for 
further details. 




32 



The Universal Parallel Interface Card 






— I 




Functional and Hardware Description 
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Functional and Hardware Description 



This chapter presents the Apple III UPIC's circuits in order of 
function: first the control circuitry, then the I/O circuitry, 

and finally the handshaking logic. Refer to the schematic in 
Appendix C as you read the descriptions. References to 
integrated circuits are by their card coordinates. These 
coordinates are written next to the part numbers for the chips 
on the schematic. Appendix D gives the pin assignments of the 
peripheral connectors on the main board inside the Apple III 
computer. All the signals that begin on the left side of the 
schematic are taken from pins in the peripheral connector slot 
where you installed the UPIC. 

In all the descriptions that follow, s denotes the slot number. 



Addressing Conventions 



There are certain addresses that you can write to or read from 
to control the operation of the UPIC. These hardware addresses 
are in the range 

C080 + s0 to C087 + s0 

For example, if you installed the UPIC in slot 3, you should 
write to the addresses from C0B0 through C0B7. 

To make this section easier to read, hardware addresses are 
given as if they were declared in an assembly language program 
written for the TLA (Pascal) assembler, the same one used for 
the two UPIC drivers. The following assembler directives assign 
a number to each of the constants for reference purposes. 
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PORTA 


.EQU 


0C080 


;Output Port A latch 


PORTB 


.EQU 


0C081 


; Output PORT B latch 


STROBE 


.EQU 


0C082 


; Send STROBE OUTPUT 


READB 


.EQU 


0C083 


;Read Input Port B 


STATUS 


.EQU 


0C084 


;DL7 ACK INPUT status, 1 = high 
;DL6 DATA READY status, 1 = high 
;DL0 ACK input, l=high code 


DATARDY 


.EQU 


0C085 


; Send DATA READY OUTPUT 


CTRLREG 


.EQU 


0C086 


;Set initialization register 
; Bit// Function 



; 0 Subtract 2us from strobe, l=on 

; 1 Add 4us to strobe width, l=on 

; 2 Add Bus to strobe width, l=on 

; 3 ACKNOWLEDGE polarity , l=positive 

; 4 DATA READY OUTPUT polarity, 

; l=positive 

; 6 l=enable DATA READY ACKNOWLEDGE 

; Interrupt Request; 0=disable 

; 7 l=enable ACKNOWLEDGE INPUT 

; Interrupt Request; 0=disable 

;NOTE: Register initialized to zero 
.EQU 0C087 ;Clear ACKNOWLEDGE, DATA READY OUTPUT 

read the value of Port B into the Accumulator, just do 
assembly language operations 

DEVOFF ;Put slot # offset into Register Y 

READB,Y ;Read port B into the Accumulator 

The second LDA operation adds the value in the Y register (the 
slot # offset) to the value in READB (the base address) and 
reads data from that address. But we are getting ahead of 
ourselves. Let's take a look at the hardware. 



CLEAR 



Thus , to 
the 6502 



LDY 

LDA 



Address Decoding 

Operations that the UPIC can perform are initiated by read or 
write operations to certain hardware addresses. IC 4C (a 
74LS138) is a 3-to-8 decoder that selects one of its outputs 
depending on the state of the address lines. When an address 
between PORTA (C080 + s0) and CLEAR (C087 + s0) is on the 
address lines, the decoder output that corresponds to the value 
of the address lines A2, A1 , A 0 goes low. The rest of the 
outputs remain high. Each of the eight output lines of the 
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decoder goes to a different part of the circuitry, turning on 
various functions. The signals are defined as follows: 



Address Lines 
A2 AX A0 


Selected 
by Address 


Name 


Circuitry Selected 


0 


a 


0 


C080 


PORTA 


Output Port A latch 


0 


0 


1 


C081 


PORTB 


Output Port B latch 


0 


1 


0 


C082 


STROBE 


Initiate STROBE OUTPUT 


0 


1 


1 


C083 


READB 


Read Input Port B 


1 


0 


0 


C084 


STATUS 


Read status bits 


1 


0 


1 


C085 


DATARDY 


Set DATA READY OUTPUT 


1 


1 


0 


C086 


CTRLREG 


Set control register 


1 


1 


1 


C087 


CLEAR 


Clear DATA READY OUTPUT 
and ACKNOWLEDGE INPUT 



For example, the circuitry to Output Port B can be selected by the 
following code. 

LDY DEVOFF ;Put slot # offset into Register Y 

STA PORTB , Y ;Send contents of Accum. to Port B 

A more complete summary of the effects of writing to the various 
addresses on the UPIC is presented at the end of the chapter. 



Control fteg/sfer 

IC 5B (a 74LS273) is an 8-bit latch that stores the current 
status of the UPIC, such as the strobe pulse duration, interrupt 
mode status, and handshaking polarity. 

Data is gated from the data bus into the status latch whenever 
CTRLREG (C086 + s0) is written to. The contents of the latch 
are set to zero whenever the IORES line goes low. This occurs 
when the power is turned on, or when a <CTRL-RESET> is done. The 
meaning of the information stored in the latch is as follows: 
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Bit # Function 

0 Subtract 2 /isec from strobe width, 1 = on 

1 Add 4 /isec to strobe width, 0=none added, 1 = on 

2 Add 8 /isec to strobe width, 0=none added, 1 = on 

3 Set ACKNOWLEDGE and DATA READY ACKNOWLEDGE INPUT 

polarities; 1 = positive 

4 Set DATA READY OUTPUT polarity ; l=positive 

5 Set STROBE polarity, l=positive 

6 l=enable DATA READY ACKNOWLEDGE Interrupt Request 

7 l=enable ACKNOWLEDGE Interrupt Request 

The parallel driver uses this register in two ways. Bits 0 
through 5 are the parameters set by the variable CTRLWRD from 
the Device Configuration Block. The drivers set these when 
the UPIC is opened. For example 

LDY DEVOFF ;Put the slot # offset into Y 

LDA CTRLWRD ;Put UPIC's parameters into Accum. 

STA CTRLREG,Y ;Save the parameters in latch 

will set the value of the control register to the UPIC 
parameters that you specified in the DCB. 

The driver uses bits 6 and 7 to maintain the current status of 
the UPIC. Bit 6, the Enable DATA READY ACKNOWLEDGE bit, enables 
or disables interrupts for read requests. Bit 7, the Interrupt 
Request bit, enables or disables interrupts for write requests. 

You can disable interrupts for read requests as follows: 

LDY DEVOFF ;Put the slot # offset into Y 

LDA CTRLWRD ;Get current status of the UPIC 

AND #0BF ;Turn off bit 6, disable reads 

STA CTRLWRD ;Update current status variable 

STA CTRLREG,Y ;Save new status in status latch 

The current status of the control register must always be 
maintained in software (CTRLWRD) since there is no way to read 
the contents of CTRLREG. 



Input Port B 

IC 6B (a 74LS244) is an 8-bit buffer that is used to transfer 
signals from the peripheral device to the Apple III. Data is 
driven from the UPIC's input lines (lines 29,28,19,17-13) onto 
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the Apple Ill's data lines (slot pins 42-49) whenever READB 
(C083 + s0) is addressed. 




PARALLEL 
DATA IN 



Figure 6-1. Input Port Block Diagram 



Output Ports A and B 

ICs 6A and 6C are 8-bit latches (74LS374) that are used to 
transfer data from the Apple Ill's data lines to the external 
device. Each of them latches, or stores, the data that is on 
the data lines when it sees the signal on its pin 11 go from a 
logic low to a logic high. 

Data is latched into Port A whenever the address PORTA 
(C080 + s0) is detected, and when the Read/Write signal (pin 18 
of the peripheral connector slot) is low; that is, data is 
latched into Port A whenever PORTA is written to. This 
operation is performed by the NOR gate 2A (a 74LS02) which is 
followed by an inverter, chip 4B (a 74LS04). The resulting 
operation is PORTA AND R/W. It goes low when a write to PORTA 
is performed, and goes high (latching the data) when the R/W line 
goes high again. 




Port A should be used whenever additional strobe lines 
are needed. Use of Port B lines for software-controlled 
strobes will result in multiple strobing because of the 
address "lookahead" feature of the microprocessor. 
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The value 00 can be placed on the output lines of Port A by the 
following instructions: 

LDY DEVOFF ;Put slot # offset into Register Y 

LDA #00 ; Clear the Accumulator 

STA PORTA, Y ;Send contents of Accum. to Port A 

Doing a write to PORTA has an additional effect. If the 
"autostrobe" feature is enabled, a delayed strobe signal is 
automatically sent. The autostrobe feature will be discussed 
later. 

The logic connected to Port B is simpler. Port B is latched 
whenever PORTB (C081) is written to or read from. The value $FF 
could be placed on the output lines of Port B by the following 
instructions : 



LDY 


DEVOFF 


;Put slot # 


offset into Register 


Y 


LDA 


#0 FF 


;Put an $FF 


into the Accumulator 




STA 


PORTB, Y 


;Send contents of Accum. to Port 


B 



APPLE 
DATA BUS 



DEVICE 

SELECT 



APPLE 

ADDRESS BUS 




PARALLEL 
DATA OUT 



PARALLEL 
DATA OUT 



Figure 6-2. Output Port Block Diagram 
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Head On/y Memory (ROM) 

IC 5C is a 512x8 ROM containing the software the UPIC uses in 
Apple II Emulation mode. The code in the ROM is divided into 
two portions. The low 256 bytes is a printer driver for 
printers that have automatic linefeed (for example, Centronics). 
The high 256 bytes contain a printer driver that adds linefeeds 
after carriage returns. These drivers are identical to those on 
the Apple II Parallel Printer and Centronics Printer cards. 

When a PR#s is done from Apple II Emulation mode, address Cs00 
is automatically set as the address of the character output 
routine. The code in the ROM is being addressed whenever the 
I/O SELECT line is low; that is, when the address on the address 
lines is between Cs00 and CsFF. (Recall that s is the slot 
number.) The lower half of the code is selected when the PRINTER 
L.F. switch (pin 19 of the ROM) is set to AUTO (the open 
position). The upper half is selected when the switch is 
closed (that is, in the NORM position). 

Through a technique called address line remapping, the state of 
the ACKNOWLEDGE INPUT signal is monitored. This allows different 
code to be executed, depending on the state of the ACKNOWLEDGE 
INPUT signal. 




Figure 6-3. Read Only Memory 
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Strobe Circuity 

IC 3B (a 74LS161) is a presettable counter used to generate 
strobe pulses from 1 ±0.5 to 15 ±0.5 microseconds in 
duration. It is clocked from the system clock, C1M, which has a 
period of about 0.98 microseconds. 

The maximum count is set by pins 5, 6 and 9 of the 74LS273 
control register, as explained in a prior section of this 
chapter. The lowest count bit is wired low, giving a minimum 
strobe width of 1 microsecond. 

The count cycle is started by a high to low transition at pin 9 
of the counter. This transition can be caused by two 
conditions : 

1. A write operation to STROBE 

2. A write operation to PORTA when autostrobe is on 

The autostrobe feature is controlled by IC IB, a 74LS74 
flip-flop. Autostrobe is turned on when address space Csxx is 
accessed. It can be turned off by a read from or a write to 
CLEAR (C087 + s0). The autostrobe feature is primarily intended 
to provide automatic strobes for Apple II Emulation mode; 
however, it can be used to help write more compact code for 
other applications. 

The output line, pin 15, remains low for the entire count cycle; 
when the maximum value is reached, the output line goes high. 
Since the output line is inverted, and then connected directly 
to the enable pin (pin 4), the counter is turned off, and the 
output remains high until a new count cycle is started. Before 
the output signal is sent to the device, it is EXCLUSIVE-ORed 
with the STROBE polarity, pin 16 of the control register. This 
causes the final STROBE signal, sent to the device through 
connector pin 18, to have the proper polarity assigned to it. 



Handshaking 

IC 3A (a 74LS74) is a D-type flip-flop that is used to handle 
much of the handshaking. Both sides of the IC are cleared by a 
write to the address CLEAR (C087 + s0) or by a low signal on 
I ORES (pin 31). The DATA READY OUTPUT (pin 33) is generated 
when DATARDY (C085 + s0) is addressed. The peripheral device 
responds by placing a signal on the DATA READY ACKNOWLEDGE line 
(pin 38), which clocks the flip-flop, removing the DATA READY 
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signal, and setting the D6 data line to a logic high. This 
response can be detected by reading from STATUS (C084 + s0), and 
testing bit 6. This sequence is generally used for input 
handshaking. A simple one-character read could be performed as 
follows : 

STA DATARDY , Y ;Set DATA READY OUTPUT 

; Clear D.R. ACKNOWLEDGE IN 

GET_STATUS LDA STATUS, Y ;Get status bits 

ASL A ;Move bit 6 to bit 7 

BPL GET_STATUS ;No ACKNOWLEDGE; try again 

LDA READB , Y ;ACK sent; read byte into 

Ac cum. 

Output handshaking is generally handled with the STROBE and 
ACKNOWLEDGE lines (pins 18 and 12). A write to STROBE (C082 + 
s0) sends the strobe signal telling the peripheral that valid 
data is on the data lines. A STROBE signal automatically clears 
the ACKNOWLEDGE bit of the flip-flop. Once the peripheral has 
read the data, it responds with the ACKNOWLEDGE (ACK) signal 
telling the computer that it has received the data. The 
acknowledge signal is placed on data line DI0, where it can be 
detected by doing a read from STATUS (C084 + s0) and testing 
bit 0. A single-byte write operation can be done through Port A 
as follows. 



STA 


PORTB ,Y 


;Place character in Port A 


STA 


STROBE, Y 


; Send STROBE OUTPUT 
; Clear ACKNOWLEDGE INPUT 


LDA 


STATUS , Y 


;Read status bits 


LSR 


A 


;Put ACK into Carry bit 


BCC 


GET ACK 


;ACK not set; try again 



The polarity of the handshaking signals (STROBE OUTPUT, 
ACKNOWLEDGE INPUT, DATA READY OUTPUT, and DATA READY ACKNOWLEDGE 
INPUT), is inverted by EXCLUSIVE-OR gate IC 4A. The state of 
the polarity is determined by the values present in bits 3, 4, 
and 5 of the Control Register. 



Connector Filters 

All of the signals on the peripheral connector are filtered to 
reduce interference by the computer with other electronics 
equipment. This filtering is done by routing each of the input 
and output lines through a ferrite core inductor and capacitor 
(LC) filter. 
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Summary of Hardware Addresses 



PORTA 


C080 + s0 


1 . 


A write to PORTA will latch whatever is on the data 
lines into IC 6C. This data remains on the 40 pin 
connector lines 20-27 until PORTA is written to again. 


2. 


If autostrobe is enabled, a write to PORTA will also 
send a STROBE signal. 


PORTB 


C081 + s0 


1 . 


A read or a write to PORTB will latch whatever is on 
the data lines into IC 6A. This data remains on the 
40 pin connector lines 1-8 until PORTB is written to 
again. For a read operation, the data on the lines is 
undefined. 


STROBE 


C082 + s0 


1 . 


A write to STROBE will generate the STROBE signal with 
duration and polarity as set in the control register. 


2. 


Mien the STROBE signal is generated, it causes the 
ACKNOWLEDGE status to be cleared (see STATUS). 


READB 


C083 + s0 


1 . 


A read of READB allows the computer to read Port B 
(IC 6B). Input Port B is 40-pin connector lines 
13-17, 19, and 28-29. 


STATUS 


C084 + s0 


1 . 


A read from STATUS will return the values of three of 



the UPIC's signals: 

DL7 = The ACKNOWLEDGE (ACK) status: 

Turned on by ACKNOWLEDGE INPUT. 

Turned off by STROBE signal or reset. 

DL6 = The DATA READY status: 

Turned on by a read or write to DATARDY. 
Turned off by a pulse on the DATA READY 
ACKNOWLEDGE INPUT line. 

DL0 = The ACKNOWLEDGE signal: 

Mirrors the ACKNOWLEDGE INPUT, but always 
is positive true logic (uses polarity). 
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2 . 

DATARDY 

1 . 

2 . 

CTRLREG 

1 . 

CLEAR 

1 . 

2 . 



If the interrupts are enabled (by setting bits 7 and 6 of 
the control register), then ACK status (DL7) and/or DATA 
READY status (DL6) will result in an IRO signal. 

C085 + s0 

A write or read to DATARDY sets the Data Ready flip-flop. 
DL6, the read interrupt bit, is turned off. 

C086 + s0 

A write to CTRLREG causes the data on the data lines to 
be latched into IC 5B. This is the control register for 
the UPIC. See its description above. 

C087 + s0 

A read or write to CLEAR clears the handshaking flip-flop. 
A read or write also disables the autostrobe feature. 
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A feature of the UPIC used with the Printer Driver is the full 
support of Apple II Emulation mode. If you have any Apple II 
software that uses your printer, and if your printer is one of 
those listed in the preface, simply plug your 20 pin printer 
connector into the UPIC (as explained in Chapter 2), put the 
Apple III into Emulation mode, and let it run. How to use the 
Apple Ill's Apple II Emulator is explained in the Apple III 
Owner's Guide. 

In the explanations that follow, s is the number of the slot 
in which you have installed the UPIC; <CTRL-keyname> means 
"hold down the CTRL key while pressing the key called keyname"; 
<RETURN> denotes the RETURN key, etc. 



Setting the Strobe 

Turning the Apple III on or pressing <CTRL-RESET> automatically 
sets up the UPIC for the most commonly used printers; that is, 
the UPIC issues negative STROBE pulses that are 3;us long, and it 
expects to receive negative ACKNOWLEDGE pulses. All of the 
commonly used printers listed in the preface expect the same 
setting (CTRLWRD =00). 

If your printer requires a STROBE pulse of a different length, 
or if it uses STROBE or ACKNOWLEDGE signals of positive 
polarity, then you must POKE the proper value into the control 
word (CTRLWRD) at address C086 + s0 on the UPIC. (CTRLWRD 
is simply a name for DCB parameter 3, shown in Table 2-4.) 

Table A-l shows how the bits in the control word, and hence 
in the value you must POKE, are assigned. 
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CTRLWRD Bit # 


Function 


0 (right bit) 


Subtract 2^is from STROBE width. 1 = on 


1 


Add 4us to the STROBE width. 1 = on 


2 


Add 8^is to the STROBE width. 1 = on 


3 


Set ACKNOWLEDGE polarity. 1 = positive 


4 


Not applicable 


5 


Set STROBE polarity. 1 = positive 


6 


Set to low (0) 


7 (left bit) 


Set to low (0) 



Table A-l. CTRLWRD (Control Word) Bit Assignments 



For example, if your printer requires positive handshaking, and 
a strobe length of 5/is, you want to set the control word bits to 
00101011. This corresponds to a decimal value of 43. If your 
UPIC is in slot 1, then the desired address is C086 + 10 = C096, 
which is 49302 in decimal. So do this: 

POKE 49302,43 :REM INITIALIZE CONTROL REGISTER 



Turning the UPIC On and Off 




The following commands all pertain to Apple II 
Emulation mode only. They have no effect when the 
Apple III is not in Emulation mode. 



You can turn on the printer from the keyboard with the command 
s < CTRL — P > <RETURN > 



(UPIC is in slot s), and turn it off with the command 
0 <CTRL-P > <RETURN > 



From BASIC the command 
PR#s <RETURN> 



turns on the UPIC. All subsequent output will go to the printer 
as well as to the screen. 
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When you use the command 
PR#0 <RETURN> 

all subsequent output will go to the screen only. 



UPIC Commands 



In Emulation mode, the Universal Parallel Interface Card 
commands take the form 

<CTRL-I> <command> <RETURN> 

In the case of the Change Line Width (N) command, there is also 
a number before the command indicating the new line width to 
use. 

Each command must be preceded by <CTRL-I> (or another control 
character; see next paragraph) and followed by <RETUR.N>. 

You can change <CTRL-I> to any other control character from 
<CTRL-A> through <CTRL-Z> by simply typing <CTRL-I> followed by 
the new control character; typing the two in reverse order 
changes it back. For example, typing <CTRL-IXCTRL-Q> changes 
the control character to <CTRL-Q>; typing <CTRL-QXCTRL-I> 
changes it back. This is useful if you want to list on the 
printer a program that contains <CTRL-I>. 

You can type in these commands at the keyboard or embed them in 
programs (for example, in a BASIC PRINT statement). 

Change Line Width (line- width N) 

The N command changes the number of characters printed per line 
from its current value to the one specified by line-width. 

Legal values of line-width are from 40 through 255. The default 
line width is 40. This command also turns off the video screen. 

For example, to print data on an 80-column printer, type in 

<CTRL-I>80N<RETURN> 
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Restore Video Display (I) 

The I command restores the video display as the output device, 
and changes the line width back to 40. 



Toggle the Linefeed Switch (K) 

If the Printer L.F. switch on the UPIC is set to NORM, the K 
command causes the UPIC to suppress linefeed characters normally 
sent to the printer after each carriage return character. Type 
the command again, and the UPIC will resume sending 
linefeeds . 

If the Printer L.F. switch is in the AUTO position, this 
command has no effect. 




Some printers don't print out a line until they receive 
the linefeed character. Turning off linefeed may cause 
some printers to stop printing altogether. 



Here is a BASIC program that sets the printer width to 132, 
prints a line on the printer only, and then prints another line 
on both the screen and the printer. Notice that the line width 
is reset to 40 when output to the screen is turned back on. 



10 


PRrfl : 


:REM TURN < 


ON CARD 


20 


1$ = ’ 


i it 


:REM 


30 


PRINT 


1$; "132 N" 


:REM 


40 






REM 


50 


PRINT 


"THIS LINE 


PRINTS 


60 


PRINT 


M 

</> 

M 


:REM 


70 


PRINT 


"THIS LINE 


PRINTS 


80 


PR//0 




:REM 


90 


END 







IN SLOT 1 

SET 1$ TO CONTROL- I 
SET LINE WIDTH TO 132 
ALSO TURNS OFF SCREEN 
ON THE PRINTER ONLY" 
RESTORE VIDEO, 40 COLUMNS 
ON THE PRINTER AND SCREEN" 
TURN THE CARD OFF 



For more information about use of the Apple III UPIC in 
Emulation mode, please refer to the Apple II Parallel Printer 
Card Manual or Centronics Printer Card Manual. 
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Control and Status Requests 



A number of SOS control and status requests are available for 
controlling the operation of a device and checking its 
condition. The next two sections explain their significance as 
used by the Printer Driver and the Parallel Driver. The 
section after that discusses how to make your own Pascal 
requests. The final sections list the demonstration programs. 



Printer Driver Control and Status Requests 



Using these control and status requests, you can write programs 
that constantly monitor the status of the printer. If the 
printer is turned on, has a good ribbon, and has paper, then 
your program can safely send information to it; otherwise the 
program should send a diagnostic message to the screen. 



Control Request #0 

This request resets the Printer Driver, clearing its output 
buffer of all information currently waiting to be printed. This 
request also turns off interrupts on the UPIC; thus if the 
printer sends an ACKNOWLEDGE signal after the Apple sends 
Control Request 0, the UPIC will not respond. (Normally, when 
the UPIC receives the acknowledge signal, the Printer Driver 
responds by sending characters from the buffer to the printer.) 



Control Request #1_ 

This SOS request sends six bytes to the printer: first a byte 
containing the number of bytes that follow (05); then a five 
byte status table ~ ERRMASK, ERRSTAT, AUTOLF, CTRLWRD , and 
TIMEOUT, in that order. All five of these bytes are discussed 
in Chapter 4. 
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Control Request #_ 2 

This SOS request normally indicates to the printer what 
character should trigger a new line. It is not implemented in 
.PRINTER. 



Status Request #0 

No operation is defined for this request. 



Status Request #1_ 

This SOS request causes the printer to send back six bytes: the 
first byte contains the byte count (05) of the status table; the 
remaining bytes are the status table itself — ERRMASK, ERRSTAT, 
AUTOLF, CTRLWRD, and TIMEOUT, in that order. These five bytes 
are explained in detail in Chapter 4. 



Status Request # 2 _ 

This SOS request normally causes the printer to send back the 
new line indicator character. .PRINTER places $00 in the 
location your call's pointer selects. 



Status Request # 3_ 

This request causes the printer to send back five bytes 
containing its (error) status and buffer sizes. 



5 


4 


3 


2 


1 


high 


low 


high 


low 


ERRSTAT 


Number of 
characters in 
output buffer 


Size of the 
output buffer 


See Table 
4-4 



Para//e/ Dr/Ver Control and Status Requests 

You can use the control and status requests described below 
to monitor the state of the device connected to your Apple 
III via the .PARALLEL driver. Later sections explain how to use 
these requests with Pascal and BASIC programs. 
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Control Request #0 

This request resets the Parallel Driver: it clears the output 
and input buffers, destroying any information not yet read or 
written. It also turns off the interrupts on the card. As a 
result, if you issue Control Request #0, the UPIC will not 
respond to an ACKNOWLEDGE signal by sending more characters 
to the buffer (which it would normally do). Control Request #0 
also causes THREAD and LFREM to be reloaded from the DCB. 



Control Request #1_ 

This SOS request sends the parallel device four bytes: the first 
byte contains 03 (the byte count of what follows); the remaining 
three bytes contain the new values for LFREM, IMREAD, and 
CTRLWRD. All three of these bytes are explained in Chapter 5. 

These values override those in the DCB until a later Control 
Request #0 resets the driver or a BASIC command opens the 
driver again. 



Control Request # 2 

This request always sends two bytes to SOS: the first byte sets 

the switch IS_NEWLINE to either $FF (terminate an SOS read 
request if it reads the same character as the one stored in 
NEWLINE) or $00 (ignore NEWLINE). The second byte places the 
character in NEWLINE that will prematurely terminate an SOS read 
request if IS_NEWLINE is set to $FF. 



Status Request #0 

No operation is defined for this SOS request. 



Status Request #1_ 

This SOS request causes the driver to return four bytes: the 
first byte contains 03 (the number of bytes that follow); the 
remaining three bytes contain the current values of LFREM, 
IMREAD and CTRLWRD. These three bytes are explained in 
Chapter 5. The values returned by Status Request #1 can be 
changed with Control Request #1. 



Status Request #2 

This request has a pointer that indicates where to store the 
current value of IS_NEWLINE (the first byte) and NEWLINE (the 
second byte) that the driver is using. 
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Status Request #3_ 

This request returns eight bytes describing the current state 
of the buffers: 



8 


7 


6 


5 


4 


3 


2 


1 




low 


high 


low 


high 


low 


high 


low 


Number of 


Size of input 


Number of 


Size of 


output 


bytes in 
input buffer 


buffer 


bytes in 
output buffer 


buffer 



Making Your Own Pascal Requests 



This section explains how to make your own Pascal status and 
control requests for any of the functions outlined above. 

In Pascal, the information needed for a status or a control call 
can be represented by the following record declaration: 

STATUS = RECORD 

UNIT_NUMBER: INTEGER; 

STATUS_BYTES: PACKED ARRAY [0.. 59] OF CHAR; 

CONTROL_CODE : CONTROL_FORMAT 
END; 

for which the CONTROL_FORMAT has been declared to be 

CONTROL_F ORMAT = PACKED RECORD 
IODIR: (OUT, IN); 

CALL_TYPE : (STATUS , CONTROL) ; 

REQUEST_CODE : 0..2047 
END; 

A control or status request is made using the UNITSTATUS 
function, a standard Apple III Pascal procedure. For example 

UNITSTATUS (STAT.UNIT NUMBER, STAT. STATUS BYTES , STAT • CONTROL__CODE ) ; 



could be used to make a status or control request from a Pascal 
program. STAT is a record of type STATUS, and the three 
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parameters referenced are as declared in the record above. 

Notice that the second parameter is a pointer to the 60 byte 
buffer. 

For a control request the value of UNIT_NUMBER must be set to 
the standard Pascal unit number of the device. If your UPIC is 
the Pascal unit PR.INTER: , then the value of UNITSTATUS is 

STAT . UNIT_NUMBER := 6; 

Information sent or received by the request is transferred in 
the 60-byte buffer, STATUS_BYTES . For control requests, you 
must assign values to certain bytes of STATUS_BYTES , as required 
by that particular control request. Status requests cause the 
driver's status routine to place values in the buffer. 

The boolean CONTROL_CODE . CALL_TYPE tells the driver whether the 
call is a control or a status request. The value of 
CONTROL_CODE.REQUEST_CODE indicates to the driver which control 
or status request is desired. Finally, CONTROL_CODE. IODIR 
indicates whether the call applies to an output or input channel 
for a unit. The format of the control code is as follows. 



15 13 


12 




1 


0 






n 


□ 


<-not used-> < — 


REQUEST CODE — > 




t 

IODIR 



CALL TYPE 

CALL_TYPE should be 0 for a status call and 1 for a control 
call. IODIR should be 0 if the call applies to an output 
channel for a unit or 1 if the call applies to an input channel 
for a unit. 

For example, CONTROL_CODE for Control Request #2 to PRINTER: 
(unit #6) would be: 

STAT • UNIT_NUMBEPv := 6; 

S TAT. CONTROLJCODE. IODIR := OUT; 

S TAT . CONTROL_CODE • CALL_TYPE := CONTROL; 

STAT. CONTROL CODE. REQUEST CODE := 2; 
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This is the Parallel I/O Driver control request which is used to 
set the NEWLINE character. The entire call would be 



WITH STAT DO BEGIN 
UNIT_NUMBER := 6; 

STATU S_BYTES [ 0 ] := 255; 

STATUS_BYTES [ 1 ] := 33; {set NEWLINE to 

CONTROL__CODE • IODIR := OUT; {output channel 

CONTROL j:ODE.CALL_TYPE := CONTROL; {Control request 
CONTROL_CODE.REQUEST_CODE := 2; {Control request 
UNITSTATUS (UNIT_NUMBER, STATU S_BYTES , CONTROL_CODE ) ; 
END; {WITH STAT DO} 



{Request to printer} 
{Turn IS_NEWLINE on} 
!"} 
} 
} 

2 } 



Demonstration Software Listings 



The UPIC diskette contains, besides the .PRINTER and .PARALLEL 
drivers, three demonstration software programs written in 
BASIC. 

To run one of these modules (for example, DEMO .PRINTER) , from 
the keyboard, type: 

PREF IX$ = /PARALLEL . CARD / 

RUN DEMO. PRINTER 

To call one of the programs from another BASIC program, use: 

10 PREFIX$=".dl" 

20 INVOKE "REQUEST" 

30 RUN"DEM0. PRINTER" 

In the program listings that follow, some lines have been 
arbitrarily split into two or three shorter lines to make them 
fit more easily into the formatted width of the manual's pages. 
Each unnumbered line is the continuation of the line that 
precedes it. 

DEMO.PRINTER Listings 

5 HOME 

10 INVOKE "request" 

20 DEVICE$=". PRINTER" 

30 0PEN#1,DEVICE$ 

40 GOSUB 30000 
50 ON KBD GOTO 50000 
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90 GOSUB 40000 

95 IF chars . in>0 GOTO 90 

100 PRINT//1 ; "This is line number "line.no" 
being sent to the printer " 

110 line.no=line.no+l 
115 ON KBD GOTO 50000 
120 GOTO 90 

29999 REM 

30000 REM Request Device Configuration parameters 

30001 REM 
30010 req.num=l 

30020 PERFORM status (%req .num, @string$ )device$ 

30030 e r rma sk= AS C ( MID $ ( string$ , 2,1)) 

30040 errstat=ASC(MID$(string$ ,3,1)) 

30050 autolf =ASC(MID$ (string$ ,4,1)) 

30060 ctrlwrd=ASC(MID$(string$ ,5,1)) 

30070 timeout=ASC(MID$ (string$ ,6,1)) 

30199 REM 

30200 REM Test for printer error 

30201 REM 

30205 PRINT: PRINT "ERRMASK is $"HEX$(errmask)" 

ERRSTAT is $"HEX$(errstat ) 

30210 IF errmask=0 GOTO 30400 

30215 PRINT :PRINT"The following error conditions 
can be generated" 

30217 PRINT" by the parallel printer :" : PRINT 
30220 IF errmask>127 THEN PRINT TAB(10); 

"Printer power off ":errmask=errmask-128 
30230 IF errmask>63 THEN PRINT TAB( 10 ); "Printer off line": 
errmask=errmask-64 

30240 IF errmask>31 THEN PRINT TAB(10) ; "Printer out of paper": 
e rrmask=er rmask-3 2 

30250 IF errmask>15 THEN PRINT TAB(10) ; "Printer ribbon out ": 
errmask=errmask-16 

30260 IF errmask>7 THEN PRINT TAB(10) ; "Printer in check ": 
errmask=errmask-8 

30270 IF errmask>0 THEN PRINT TAB( 10 ); "Printer receives 
undefined error" 

30400 PRINT: PRINT "Auto linefeed is ";:IF autolf=64 
THEN PRINT"enabled" : ELSE PRINT"disabled" 

30410 PRINT: PRINT "CTRLWRD is $"HEX$ (ctrlwrd) 

30500 PRINT :PRINT"The printer driver will timeout after waiting 
"timeout*ll" microseconds" 

30600 PRINT : PRINT "Would you like to change any of these 
parameters (Y/N) ?"; 

30610 GET a$: PRINT a$ 

30620 IF a$<>"Y" AND a$<>"y" THEN RETURN 

30630 PRINT :PRINT"What value should the ERRMASK be ( 00- FF) "; 
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30640 INPUT a$ 

30650 errmask=TEN(a$) 

30660 PRINT :PRINT"What value should ERRSTAT be (00-FF) M ; 

30670 INPUT a$ 

30680 errstat=TEN(a$ ) 

30690 PRINT :PRINT M Should autolinefeed be enabled (Y/N) ?"; 

30700 GET a$ : PRINT a$ 

30701 IF a$="Y" OR a$= M y M THEN autolf=64:ELSE autolf=0 
30703 PRINT :PRINT"What value should CTRLWRD be (00-FF) 

30705 INPUT a$ 

30707 ctrlwrd=TEN(a$) 

30720 PRINT: PRINT "How many microseconds should the driver 
what till timeout 
30730 INPUT a 
30740 timeout=a/ll 

30750 IF timeout>255 THEN timeout=255 

30760 string$="5"+CHR$ (errmask)+CHR$ (errs tat )+CHR$ (autolf ) 

+CHR$ (ctrlwrd)+CHR$( timeout) 

30770 PERFORM control(%req • num, Qstring$ )device$ 

30900 GOTO 30000 

39999 REM 

40000 REM Request error status and buffer size 

40001 REM 
40010 req.num=3 

40020 PERFORM status (%req .num, @string$)device$ 

40030 error . status$=MID$ (string$, 1,1) 

40040 error . status=ASC (error . status $) 

40050 buf .size.low$=MID$(string$,2, 1 ) 

40060 buf . size.high$=MID$(string$, 3 , 1 ) 

40070 buf . size=ASC(buf . size . low$ )+ASC(buf . size .high$ ) *256 
40080 chars. in. low$=MID$(string$, 4,1 ) 

40090 chars • in.high$=MID$(string$, 5,1) 

40100 chars • in=ASC( chars . in. low$)+ASC( chars . in. high $) *256 

40199 REM 

40200 REM Test for printer error 

40201 REM 

40210 IF error . status=0 GOTO 40400 

40220 IF error . status>127 THEN PRINT"Printer power off": 

GOTO 40300 

40230 IF error . status>63 THEN PRINT M Printer off line": GOTO 40300 
40240 IF error. status>31 THEN PRINT"Printer out of paper": 

GOTO 40300 

40250 IF error. status>15 THEN PRINT"Printer ribbon out ": 

GOTO 40300 

40260 IF error. status>7 THEN PRINT"Printer in check ": 

GOTO 40300 

40270 PRINT"Printer in undefined error": GOTO 40300 
40300 PRINT "Press RETURN when fixed " 
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40310 GET a$ 

40320 GOTO 40000 

40400 PRINT chars. in" characters in buffer - 
Room for M buf . size-chars . in" more" 
40410 RETURN 
50000 END 



DEMO. PARALLEL Listings 

10 INVOKE "request" 

20 DEVICE$=". Parallel" 

30 OPEN# 1,DE VICE $ 

50 HOME 

100 PRINT"Do you want to remove linefeeds ": 

PRINT" that immediately follow carriage returns (Y/N) ? "; 
110 GET If rem$ 

1 1 5 PRINT LFREM$ : PRINT 

120 PRINT"Do you want to recieve the contents ": 

PRINT"of the input buffer immediately 
instead of after newline character (Y/N) ? "; 

130 GET imread$ 

140 PRINT IMREAD$: PRINT 

145 PRINT :PRINT"What value do want to set CTRLWRD (00-FF) "; 

147 INPUT a$ : ctrlwrd$=CHR$ (TEN(a$) ) 

148 PRINT 

150 IF If rem$="y" OR lfrem$="Y" THEN If rem$=CHR$(64) : 

ELSE If rem$=CHR$ (0 ) 

160 IF imread$="y" OR imread$="Y" THEN imread$=CHR$ (64) : 

ELSE imread$=CHR$ (0) 

170 table. string$=CHR.$ (3)+lf rem$+imread$+ctrlwrd$ 

175 vnew. string$=CHR$ (0)+CIlR$ (0) 

180 PRINT"Do you want input terminated by ": 

PRINT"some thing other than the character count (Y/N) ? "; 
190 GET is.newline$ 

195 PRINT IS.NEWLINE$: PRINT 

200 IF is . newline$="y" OR is.newline$="Y" 

THEN PRINT "What character (Hit character) ? "; : 

GET newline$ : vNEW. string$=CHR$(255 )+newline$ 

205 PRINT 
210 req.num=l 

220 PERFORM control(%req.num,@table.string$)device$ 

230 req.num=2 

240 PERFORM control(%req.num,@vNEW.string$)device$ 

39999 REM 

40000 REM Request error status and buffer size 

40001 REM 
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40010 req.num=3 

40020 PERFORM status (%req.num, @string$)device$ 

40050 o.buf .size.low$=MID$(string$, 1,1) 

40060 o.buf .size.high$=MID$( string?, 2, 1 ) 

40070 o.buf .s ize=ASC( O.buf . size. low$)+ASC( O.buf . size. high$) *256 
40080 o. chars . in. low$=MID$ (string$ ,4,1) 

40090 o. chars . in.high$=MID$ (string?, 3, 1) 

40100 o . chars . in=ASC (0 . chars . in. low$ )+ASC(0. chars . in.high$ ) *256 
40150 i.buf .size.low$=MID$(string$,5, 1) 

40160 i.buf . size.high?=MID?( string? ,6,1) 

40170 i .buf .size=ASC (I .buf .size. low$)+ASC( I.buf .size .high$)*256 
40180 i .chars .in. low$=MID$ (string$ ,7,1) 

40190 i. chars .in.high?=MID?(string?,8, 1) 

40200 i. chars . in=ASC(I . chars . in. low?)+ASC(I . chars . in.high$ )*256 
40250 PRINT 

40300 PRINT o. chars. in" characters in output buffer - 
Room for "o.BUF. SIZE-0. CHARS. IN" characters" 

40310 PRINT i. chars. in" characters in input buffer - 
Room for "i. BUF. SIZE-I. CHARS. IN" characters" 

45000 REM New line 
45010 req.num=2 

45020 PERFORM status (%req .num, @string?)device? 

45030 PRINT 

45050 IF ASC(MID$ (string $ ,1,1))>127 

THEN PRINT"Newline character active - 
Character is $"HEX$ (ASC (MID$ ( s t r ing$ , 2 , 1 ) ) ) " 
decimal "ASC(MID$ (string$ ,2 , 1 ) )" '"MID$(string$ ,2, 1)"'" 
55000 REM Status table 
55010 req.num=l 

55020 PERFORM status (%req .num, Ostring? )device$ 

55030 PRINT 

55050 IF ASC(MID$ (string$ , 2 , 1 ) )>63 

THEN PRINT"Line feed remove on output active": 

ELSE PRINT"Line feed remove inactive" 

55055 PRINT 

55060 IF ASC(MID$ (string? ,3,1) )>63 

THEN PRINT"Immediate read on input": 

ELSE PRINT "Immediate read inactive" 

55070 PRINT : PRINT "CTRLWRD is $"HEX$(ASC(MID$(string$ , 4 , 1 ) ) ) 

DEMO. DEVIN FO Listings 

5 ON ERR GOTO 90 
10 INVOKE "request" 

50 HOME 
90 PRINT 

100 INPUT"Name of device driver (Include period) ? ";device$ 
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1 10 IF device$= ,m THEN END 
120 GOSUB 30000 
130 GOTO 90 

30000 REM Device Information 

30010 PERFORM devinf o(@string$ )device$ 

30020 slot=ASC(MID$ (string$, 1,1)) 

30030 devtype=ASC(MID$(string$ ,3,1)) 

30040 subtype=ASC(MID$(string$ ,4,1)) 

30050 manid=ASC(MID$(string$ ,8, 1 ) ) 

30060 ve r num $ =RI GHT $ (HEX$ (ASC(MID$ (string$ , 1 1 , 1 ) ) ) , 2 )+RIGHT$ 
(1IEX$ (ASC (MID$ (st ring$ , 10 , 1 ) ) ) , 2 ) 

30070 PRINT 

30100 IF devtype=97 AND subtype=l THEN PRINT" . CONSOLE driver" 

30110 IF devtype=66 AND subtype=l THEN PRINT" .GRAPHICS driver" 

30120 IF devtype=65 AND subtype=0 THEN PRINT"parallel printer 

driver" 

30125 IF devtype=65 AND subtype=l THEN PRINT" .SILENTYPE driver " 

30130 IF devtype=65 AND subtype=2 THEN PRINT"serial printer 

driver" 

30140 IF slot=0 THEN PRINT"Not in a slot": 

ELSE PRINT"In slot "slot 

30150 IF manid=l THEN PRINT"Manuf actured by Apple Computer" 

30160 PRINT"Version number "vernum$ 

30300 RETURN 
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Specifications 



The Apple III Universal Parallel Interface Card has these 
features and characteristics: 

- Sixteen output lines 

- Eight input lines 

- STROBE OUTPUT, ACKNOWLEDGE INPUT, DATA READY OUTPUT and 
DATA READY ACKNOWLEDGE INPUT signals 

- Full software control of STROBE length from 1 to 15 jus 

- Maskable interrupts on ACKNOWLEDGE and DATA READY ACKNOWLEDGE 
Either polled or interrupt mode 

- Autostrobe feature for Apple II Emulation mode 
Autostrobe feature usable in Apple III Native mode 

- Full support of Apple II Emulation mode for all languages 

- ROM emulation code support of normal or auto-linefeed printers 

- RFI-proof signal conditioning (using LC filters) 

- Low-power Schottky TTL inputs with 1000 ohm pullup resistors 
Outputs drive 24 mA LOW and 2.6 mA HIGH 

- Operation temperature range: 0 to 50°C 

- Power consumption: 170 mA at +5 volts 

- Weight: 140 grams 

- Dimensions: 11 x 19 cm (fits standard Apple III I/O slot) 
Special single connector fits both standard 20-pin or full 

40-pin cable connections 
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SIGNAL DESCRIPTION FOR PERIPHERAL I/O CONNECTORS 

In or 

Pin # Pin Name Out ** Description 

1 I/O SELECTx 0 256 addresses are set aside 

for each peripheral connector 
A read or write at such an 
address will send Pin 1 on the 
selected connector low during 
the micro PH0 (Phase 0; nominally 
500ns in 1MHz mode; 250ns in 2MHz 
mode) . 
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2-17 A0-A15 

18 R/W 

19 PH0 



20 I/O STROBE 

21 RDY 



22 TSADB 

23 

24 

25 +5V 

26 GND 



1,0 16-bit system address bus. 

Addresses are set up by the 6502 
within 300ns after the beginning 
of C1M. 

1,0 READ /WRITE line from 6502. When 

high, indicates that a read cycle 
is in progress; when low, indicates 
that a write cycle is in progress. 

0 1 or 2MHz signal coincident with 

the operation mode of the Apple III, 
which operates on a dual clock 
system and gains operational speed 
by using a 2MHz clock at certain 
times. 

0 Pin 20 on all peripheral connectors 
will go low during the micro PH0 of 
a read or write cycle to any address 
$C800-$CFFF • 

1 "Ready" line to the 6502. This line 
should change only during C1M, and 
when low will halt the microprocessor 
at the next READ cycle. This line 
has a IK ohm pullup to +5V. 

I A low on this line from the periph- 

eral will cause the address bus to 
tri-state for Direct Memory Access 
(DMA) applications. Has a IK ohm 
pullup to +5V. 

NA Not used in Apple III (no daisy 

chaining of peripherals). 

NA Not used in Apple III. 

0 Positive 5-volt supply*, 2.0 amps 

total for all peripheral boards 
together (but note limit of 1.5 W 
per board). 

NA System circuit ground. 0 volt 

line from power supply. Do not use 
for shield ground. 
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27 


DMAOK 


0 


ACKNOWLEDGE signal to the peripheral 
following its request for the special 
Direct Memory Access (DMA) mode. 
Informs the peripheral that the DMA 
can now proceed. 


28 


DMAI 


I 


Direct Memory Access (DMA) Interrupt. 
Requests the Apple Ill's DMA mode. 

Has a IK ohm pullup to +5V. 


29 


IONMI 


I 


Input /Output Non-Maskable Interrupt. 
The non-maskable interrupt does not 
go directly to the processor, so it 
can be masked by the system reset 
lock function. 


30 


IRQx 


I 


Interrupt request line. Each periph- 
eral signal goes to an individual 
gate input and therefore can be 
driven by a normal TTL output. 


31 


IORES 


0 


Input /Output Reset signal used to 
reset the peripheral devices. 

Pulled low by a power on or Reset 
in the Emulation mode or a Control- 
Reset. 


32 


INH 


I 


Inhibit line. When a device pulls 
this line low, all system memory 
is disabled . This line has a IK 
ohm pullup to +5V. 


33 


-12V 


0 


Negative 12 volt supply*, 200mA 
total for all peripheral boards 
together. 


34 


-5V 


0 


Negative 5 volt supply*, 200mA 
total for all peripheral boards 
together. 


35 


SYNC 


0 


The 6502 opcode synchronization 
signal. Can be used for external 
bus control signals. 


36 


C7M 


0 


Seven MHz high frequency clock. 


37 


Q3 


0 


A 2MHz (nonsymmetrical) general 
purpose timing signal. 




